ZerGo0_Bot Documentation

Appearance

Fansly Discord Integration ​

The Fansly Discord Integration allows you to automatically manage Discord server roles based on your fans' Fansly subscription status.

Overview ​

With this integration, you can:

  • Automatically assign Discord roles based on Fansly subscription tiers
  • Allow fans to link their Fansly and Discord accounts with simple commands
  • Sync roles automatically every 15 minutes
  • Manage multiple subscription tiers with different Discord roles
  • Map multiple Discord roles to a single Fansly tier
  • Assign global roles to all subscribers and to followers
  • Remove roles automatically when subscriptions expire

Prerequisites ​

Before setting up the integration, you'll need:

  • An active Fansly creator account
  • A Discord server where you have administrator permissions
  • The ability to create a Fansly Management Session

Setup Instructions ​

Follow these steps to set up the Fansly Discord Integration:

1. Create a Fansly Management Session ​

  1. Go to the Fansly Management page: https://fansly.com/creator/management
  2. Click "Create Session"
  3. Enter your 2FA code when prompted
  4. Toggle all checkboxes OFF (the integration only needs read access)
  5. Click "Create"
  6. Click "Copy Link" for the newly created session

2. Configure the Integration ​

  1. Open the ZerGo0_Bot settings page: https://zergo0_bot.zergo0.dev/user/me/settings
  2. Select "Fansly Discord Integration" in the select element (top left side where it says "General")
  3. Paste the Management Session URL from step 1.6 into the "Management Session URL" field
  4. Click "Save"

3. Add the Bot to Your Discord Server ​

  1. Click the "Invite Bot to Discord" button
  2. Select your Discord server from the dropdown
  3. Review and approve the requested permissions
  4. Complete the authorization

4. Configure Bot Role Hierarchy ​

Important: The bot's role must be positioned higher than any roles it will manage.

  1. Go to your Discord Server Settings > Roles
  2. Find the bot's role (usually named after the bot)
  3. Drag it above all subscription roles you plan to assign
  4. Save the changes

5. Link Your Discord Server ​

  1. After saving the integration settings, a link token will appear: /server-link token:YOUR_TOKEN
  2. Copy the entire command
  3. Go to any channel in your Discord server
  4. Paste and send the command
  5. The bot will confirm successful server linking

6. Configure Subscription Tier Mappings ​

  1. Refresh the settings page: https://zergo0_bot.zergo0.dev/user/me/settings
  2. After successful server linking, the "Subscription Tier Mappings" section will appear
  3. For each Fansly subscription tier you offer:
    • Select a Discord role from the dropdown
    • Click "Map Role" to add it
    • Repeat to add multiple roles to the same tier if desired
  4. Special tiers available in the list:
    • All Subscribers - applies to any active subscriber (in addition to their tier roles)
    • Followers - applies to linked Discord users who follow you on Fansly
  5. All mapped roles are automatically assigned based on the user's status (tier, subscriber, follower)

7. Test the Integration ​

Your fans can now link their accounts using these simple steps:

  1. In your Discord server, they type: /link
  2. The bot provides a token (expires in 5 minutes)
  3. In any Fansly chat, they type: !link TOKEN
  4. The bot confirms successful linking and assigns appropriate roles (might take a few minutes to sync)

Discord Commands ​

For Server Admins ​

Links your Discord server to your Fansly account.

  • Usage: /server-link token:YOUR_TOKEN
  • Required: Server administrator permissions
  • Note: Token is obtained from the ZerGo0_Bot settings page

For Users ​

Generates a token to link your Discord account with your Fansly account.

  • Usage: /link
  • Returns: A 5-minute expiration token to use in Fansly chat
  • Example Response: "Your link token: ABC123 (expires in 5 minutes)"

/reset ​

Unlinks your Discord account from your Fansly account.

  • Usage: /reset
  • Effect: Removes all subscription roles and unlinks accounts

Fansly Chat Commands ​

Complete the account linking process from Fansly chat.

  • Usage: !link TOKEN
  • Example: !link ABC123
  • Note: Token must be obtained from Discord /link command first

Managing Tier Mappings ​

Adding a Tier Mapping ​

  1. Navigate to the Tier Mappings section in settings
  2. Find the Fansly tier you want to map
  3. Select a Discord role from the dropdown
  4. Click "Map Role"

Removing a Tier Mapping ​

  1. Find the mapped tier in the list
  2. Click "Remove" next to the mapping
  3. Confirm the removal

Syncing Roles ​

  • Automatic Sync: Roles are synchronized every 15 minutes automatically
  • Manual Sync: Click the "Refresh" button to trigger an immediate sync
  • Last Sync Time: Displayed at the top of the Tier Mappings section

How It Works ​

Account Linking Process ​

  1. User requests a link token in Discord (/link)
  2. Bot generates a unique 5-minute token
  3. User enters token in Fansly chat (!link TOKEN)
  4. System verifies the user's Fansly account
  5. Accounts are linked and stored securely
  6. Appropriate Discord roles are assigned based on subscription status

Role Management ​

  • Active Subscribers: Receive all Discord roles mapped to their active tier, plus any roles mapped to All Subscribers
  • Followers: Linked Discord users who follow you receive any roles mapped to Followers
  • Expired Subscriptions: Roles that no longer apply are automatically removed
  • Tier Changes: When a fan changes tiers, their assigned roles are recalculated
  • Role Updates: Occur during automatic sync (every 15 minutes) or manual refresh

Troubleshooting ​

Common Issues ​

"Discord server not linked" ​

  • Ensure you've completed step 5 (Link Your Discord Server)
  • Verify the bot is in your Discord server
  • Check that you used the correct link token

Roles not being assigned ​

  • Verify the bot's role is higher than subscription roles in Discord
  • Check that tier mappings are configured correctly
  • Ensure the user has an active subscription
  • Try manual refresh to force a sync

"Management session expired" ​

  • Create a new Management Session in Fansly
  • Update the URL in bot settings
  • Save the changes
  • Ensure the integration is enabled in settings
  • Verify the Discord server is properly linked
  • Check that the user is using the correct token format
  • Tokens expire after 5 minutes - generate a new one if needed

Permission Requirements ​

The Discord bot requires these permissions:

  • Manage Roles: To assign/remove subscription roles
  • View Channels: To read commands
  • Send Messages: To respond to commands
  • Use Slash Commands: To register and handle commands

Security Notes ​

  • Management Session URLs are encrypted and stored securely
  • Link tokens expire after 5 minutes for security
  • Users can only link their own accounts
  • The /reset command allows users to unlink at any time

Frequently Asked Questions ​

How often are roles updated? ​

Roles are automatically synchronized every 15 minutes. You can also trigger a manual sync using the "Refresh" button in settings.

Can fans have multiple subscription tiers? ​

No, fans can only subscribe to one tier at a time on Fansly. They will receive all Discord roles mapped to their active tier, plus any roles mapped to All Subscribers.

What happens when a subscription expires? ​

Any subscriber-managed roles that no longer apply (tier and All Subscribers roles) are removed during the next sync cycle. Follower roles are kept only if the user still follows you.

Can I map multiple Discord roles to a single Fansly tier? ​

Yes. Each Fansly tier can have multiple Discord roles mapped to it. All mapped roles are assigned while the subscription is active.

What are "All Subscribers" and "Followers" roles? ​

  • All Subscribers: Any active subscriber receives these roles, in addition to their tier roles.
  • Followers: Linked Discord users who follow you on Fansly receive these roles even if they are not subscribed.

You can add these from the Tier Mappings section just like regular tiers.

Is the integration free to use? ​

Yes, the Fansly Discord Integration is free to use.

No, each Fansly account can only be linked to one Discord account at a time. Users must use /reset to unlink before linking a different account.